perm filename ESSAY.SGK[UP,DOC] blob
sn#146085 filedate 1975-02-16 generic text, type C, neo UTF8
COMMENT ⊗ VALID 00002 PAGES
C REC PAGE DESCRIPTION
C00001 00001
C00002 00002 Description
C00006 ENDMK
C⊗;
Description
Essay is a modified version of ETV, the editor. It is an
experimental document retrieval system. It allows the user to
comment on his readings, read other user's comments, and read other
text files referenced by a document.
Its operation is based on the file switching system, modified
to behave like a push down stack. Commands which switch to
references and comments save the state of the screen (name of file,
page number, line number, etc.) on the stack. The user may at any
time 'POPJ' to return to a previous state, or random access entries
on the stack.
Operation
<CTRL><META>π is the 'PUSHJ' command. It scans the page
(starting at the current line) for a file name or a pointer to a
comment. A file name is anything of the appropriate form including a
PPN. A comment pointer looks like "(Comment here by SGK on page
69.)". If a file name or comment pointer is found, the state of the
world is 'Pushed' onto the stack, and the comment or file referenced
is displayed.
<CTRL><META>G is the 'POPJ' command. It undoes the effect of
a <CTRL><META>π, bringing the user back one entry in his list of
pushed states.
<CTRL><META>∀ is the comment command. It saves the current
state on the stack, and creates a new page in the file being read.
The user is expected to type (edit) an intelligent comment, then type
<CTRL><META>G which saves the comment, and returns the user to the
place where he typed <CTRL><META>∀.
<CTRL>π is like the <CTRL>ε command in E except that it
treats the file switching data structure like a push down stack (as
do other Essay commands) This means you can return from a <CTRL>π
with a <CTRL><META>G, and is otherwise compatable with the Essay
stack.
Other commands that are useful to know about are:
<CTRL>∃ Displays the stack including stale entries
<CTRL>λ Switches to a new file, or can be used to random access
entries on the stack
Notes to authors:
If you want your document to be readable thru Essay, have it formated
for E, and put it on the [XXX,DOC] area. When you want to reference
another file in your document that is on the system, make sure that
the file name includes a PPN and page and line numbers. A typical
reference might look like this: "(See ESSAY.SGK[UP,DOC](2P69L) for
details.)".